<!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN">

<HTML>
  <HEAD>
    <META name="generator" content=
    "HTML Tidy for Java (vers. 2009-12-01), see jtidy.sourceforge.net">

    <TITLE>Debugger Launchers: drgn</TITLE>
    <META http-equiv="Content-Type" content="text/html; charset=windows-1252">
    <LINK rel="stylesheet" type="text/css" href="help/shared/DefaultStyle.css">
  </HEAD>

  <BODY lang="EN-US">
    <H1><A name="plugin"></A>Debugger Launchers: drgn</H1>

    <P>The following launchers uses Meta's <B>drgn</B> engine to explore various targets:</P>

    <H2><A name="attach"></A>Attach</H2>

    <P>The "<TT>drgn</TT>" launcher attaches to a running process via the Linux "/proc/pid"
    interface.</P>

    <H3>Setup</H3>

    <P>You must have Meta's <B>drgn</B> installed on the local system. The default behavior assumes
    you do NOT need root access to attach to a running process, i.e. it assumes you have run the
    command:</P>

    <UL style="list-style-type: none">
      <LI>
<PRE>
echo 0 &gt; /proc/sys/kernel/yama/ptrace_scope
</PRE>
      </LI>
    </UL>

    <P>using root privileges at some point. Alternately, you can prepend "sudo -E" to the drgn
    invocation line in "local-drgn.sh"". Note: <B>drgn</B> does not currently support stack
    unwinding or register access for user-mode access to running processes.</P>

    <H3>Options</H3>

    <UL>
      <LI><B>PID</B>: The running process's id</LI>
    </UL>

    <H2><A name="core"></A>Core Dump</H2>

    <P>This launcher loads a Linux core dump.</P>

    <H3>Setup</H3>

    <P>You must have Meta's <B>drgn</B> installed on the local system. No other setup is required.
    Note: Core dumps may or may not include memory, so the Dynamic Listing may or may not be
    populated.</P>

    <H3>Options</H3>

    <UL>
      <LI><B>Core dump</B>: The core-dump file</LI>
    </UL>

    <H2><A name="linux_kernel"></A>Linux Kernel</H2>

    <P>This launcher attaches to a Linux kernel via the "/proc/kcore" interface.</P>

    <H3>Setup</H3>

    <P>You must have Meta's <B>drgn</B> installed on the local system. No other setup is required.
    Note: requires root access - you will be prompted for a password in the Terminal.</P>

    <H3>Options</H3>

    <UL>
      <LI><B>None</B></LI>
    </UL>
  </BODY>
</HTML>
